home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / Slackwar / docs / slack-docs / inn / INN.ins < prev    next >
Encoding:
Text File  |  1996-05-08  |  14.5 KB  |  387 lines
  1. 06/05/96 v0.62                  INN Setup (INN.ins)
  2.  
  3. Configuration of Linux Slackware INN_PKG for use with DEMON INTERNET SERVICES
  4.  
  5.    Copyright (C) 1995,1996 Ivan A. Beveridge.      ivan@@dreamtim.demon.co.uk
  6.  
  7.    This package is freely distributable.
  8.  
  9. -----------------------------------------------------------------------------
  10.  
  11. Preliminary Information
  12. -----------------------
  13.  
  14. My system (For Your Information) is:
  15. Slackware 3.0
  16. INN_PKG installed (INN v1.4)
  17. Perl installed (from d-series)
  18. Linux Kernel 1.3.98 (bleedin' edge :^)
  19. Dummy kernel net driver installed
  20. Demon connection with PPP
  21. slurp v1.10
  22. slack2.3.help.tar.gz package (modified) from John Phillips
  23.                 (from ftp.demon.co.uk /pub/linux/Demon)
  24.  
  25. Although I set up quite a few bits up before using the Linux/Demon packages
  26. mentioned in my README, I used the scripts for connecting and checking mail
  27. and news (demon.dip, start.dip, stop.dip, querypost, procnews). My personal
  28. preference for the scripts is /usr/local/sbin (except for demon.dip, which is
  29. in /usr/local/etc), as they are locally setup. If you put them in different
  30. places (originally they were in /etc and or /sbin), then check the paths in
  31. start.dip and procnews (that should be all that has changed).
  32.  
  33. As mentioned earlier, I have included all that is required for News setup, and
  34. so have also included slurp + man page. I use slurp, as I can specify to only
  35. download a few groups, but setup more to be able to post to (via the active
  36. file).
  37.  
  38. Although it may seem nice and easy to just copy all the configuration files
  39. into the correct place and try to get it working quickly, it is normally better
  40. to look at the changes I have made and make them. I say this because you may
  41. find that some of the files I have included have been changed on your system
  42. by installing it (and hence you may have difficulties). My first recommendation
  43. is to save all "original" files with the extension ".ORIG", so that you have
  44. something to go back to in case of problems. To make changes to the files, I
  45. normally do:
  46.         cp OLD-CONFIG-FILE OLD-CONFIG-FILE.ORIG
  47.         cat NEW-CONFIG-FILE >> OLD-CONFIG-FILE
  48. This adds the new file to the end of the old one, so you can easily take the
  49. pieces that you want from the new file and delete the rest.
  50.  
  51.  
  52.  
  53. PRELIMINARY
  54. ==========
  55.  
  56. The "dummy" kernel network driver is needed for off-line news posting, etc.
  57. This driver can be compiled into the kernel, or used as a module. Setting up 
  58. the dummy driver is detailed in the BASIC package of Slack-help v2.3.0.
  59.  
  60.  
  61. CNews -> INN conversion
  62. -----------------------
  63.  
  64. This is for those of you who currently have CNews installed and would like to
  65. opt for an easier life ;^)
  66.  
  67. As INN and CNews are effectively competing packages, you must choose which one
  68. you want ... after you choose INN, carry out the following instructions:
  69.  
  70. 1) Copy any configuration files that you want to keep from your CNews setup.
  71.    I would recommend this if you have it working, in case you decide to go
  72.    back to CNews - you can always delete them later.
  73.  
  74. 2) Remove the CNews package using pkgtool (run as root and select remove
  75.    package .. .then select CNews).
  76.  
  77. 3) Remove all the directories and files that remain from the CNews package
  78.    and setup. The files that were deleted should be named in a file called
  79.    /tmp/PKGTOOL.removed. You should get an idea of what to delete from there.
  80.    Here is a list of what should be deleted from the CNews package that I
  81.    have just looked at:
  82.               rm -fr /var/lib/news
  83.               rm -fr /usr/lib/newsbin
  84.               rm -fr /usr/doc/cnews
  85.  
  86. 4) Ensure that the /etc/password entry for the user "news" is set to 
  87.    /usr/lib/news, eg:
  88.     news:*:9:13:news:/usr/lib/news:
  89.  
  90. 5) Install the INN package from the Slackware "network" series (currently on
  91.    disk n3).
  92.  
  93.  
  94. Setting up INN
  95. ==============
  96.  
  97. The INN_PKG is installed by Slackware in /usr/lib/news. The files that have
  98. been changed are found under ./usr/lib/news. Ensure all files in *your*
  99. /usr/lib/news are owned by both user and group "news". Check file ownership of
  100. all other files that you are adding using this package (assume Slackware is
  101. correct)!
  102.  
  103. For information on what each of the configuration files means, please read
  104. the FILES.descript file. It would be beneficial to read this _short_ text
  105. so you know what I have done and what it means.
  106.  
  107. The following states the files which you *must* (or may have to) configure - 
  108. these contain computer-specific information, like machine name, your domain 
  109. name, etc:
  110.  
  111. hosts.nntp
  112. ----------
  113. YOURHOST.demon.co.uk        This means that you are able to "feed" news
  114.                 to your site (from your news reader).
  115.  
  116. inn.conf
  117. --------
  118. domain:   demon.co.uk        means that news articles posted from you will
  119.                 be in domain demon.co.uk
  120. server:   YOURHOST.demon.co.uk    This sets the default NNTP server that you will
  121.                 use to *read* news. This is for when you dis-
  122.                 connect from Demon, and want to read news
  123.                 locally.
  124.  
  125. nnrp.access
  126. -----------
  127. YOURHOST.demon.co.uk:Read Post:::*
  128.                 means that you machine can read and post 
  129.                 articles to all newsgroups. Ensure that you
  130.                 put you host name in place of YOURHOST.
  131.                 (Note, if you have a domain name like 
  132.                 HOST.YOURCO.co.uk, change the name to this.
  133.  
  134. slurp.news.demon.co.uk
  135. ----------------------
  136. This file contains a timestamp. This is the last time you downloaded news.
  137. Set this to something reasonable - say yesterday. The format for the time is:
  138.         YYMMDD HHMMSS
  139.  
  140.  
  141.  
  142. Further setting up
  143. ==================
  144. Some other files need to be changed for INN to work correctly.
  145.  
  146. /etc/inetd.conf
  147. ---------------
  148. The NNTP line must be commented out. The INN daemon is used for connections to
  149. the NNTP port, not in.nntp:
  150.  
  151. #nntp   stream  tcp     nowait  root    /usr/sbin/tcpd  /usr/sbin/in.nntpd
  152.  
  153.  
  154. /etc/aliases
  155. ------------
  156. This is a list of mail aliases, as used by Sendmail and Smail. The two I have
  157. mentioned (news and usenet) are needed for reports to be sent after cronjobs.
  158. Once you have added these lines (they are aliases as root here), do not
  159. forget to run the command "newaliases" as root. This will put the aliases into
  160. a database that the mail transport agent can understand.
  161.  
  162.  
  163. /etc/syslog.conf
  164. ----------------
  165. I have added an entry to this for news.debug:
  166. news.debug                                      /var/adm/nntplog
  167.         This puts any debugging info in the file named. It is useful
  168.         for finding out any errors!
  169.  
  170. Also I have changed the original *.warn to *.err (as otherwise news articles
  171. may add a line to the log file!).
  172.  
  173.  
  174. /etc/profile and /etc/csh.login
  175. -------------------------------
  176. If you want to read news via NNTP (rather than reading the news files directly
  177. off the local Linux machine), as per tine -r, then you will need to state
  178. your NNTP server that you will read news from. This is generally your host,
  179. although it can be set to any news server you wish. You do this by setting the
  180. NNTPSERVER environment variable. This is done as follows for /etc/profile
  181. (bash, zsh and ksh shells):
  182.  
  183. export NNTPSERVER=YOURHOST.demon.co.uk
  184.  
  185. ..... and as follows for /etc/csh.login (csh shell):
  186.  
  187. setenv NNTPSERVER YOURHOST.demon.co.uk
  188.  
  189. This can just as easily be set to read news "on-line" from the Demon news
  190. server as follows (for /etc/profile):
  191.  
  192. export NNTPSERVER=news.demon.co.uk
  193.  
  194. Obviousely this will only work when connected to Demon, and may end up
  195. increasing your on-line time (and hence is not recommended).
  196.  
  197.  
  198.  
  199. Further Preparations
  200. ====================
  201. Create the following files as follows:
  202.        :>  /usr/lib/news/history
  203.        :>  /usr/lib/news/history.dir
  204.        :>  /usr/lib/news/history.pag
  205.        :>  /usr/lib/news/errlog
  206.        :>  /usr/lib/news/log
  207.  
  208. Type:
  209.     chown news.news /usr/lib/news/history*
  210.     chown news.news /usr/lib/news/*log
  211.     chmod 644 /usr/lib/news/history*
  212.     chmod 644 /usr/lib/news/*log
  213.  
  214.  
  215. Run the program /usr/lib/news/tools.linux/makedirs.sh
  216. -----------------------------------------------------
  217. This creates the directories for the news articles to go into. It is run as:
  218.     sh makedirs.sh
  219.  
  220.  
  221. Read the file /usr/lib/news/tools.linux/INSTALL-linux
  222. -----------------------------------------------------
  223. Most of the above info has been gleaned from this file.
  224.  
  225.  
  226.  
  227. Trying out INN
  228. ==============
  229. Reboot your machine, for the inetd and syslogd configurations to take place
  230. (this can be carried out by killing the daemons, if you know what you are
  231. doing, but is more awkward).
  232.  
  233. Ensure all the files you have changed in /usr/lib/news are owned by news.news.
  234.  
  235. Check to see if INN is working now. Use the following command to start INN,
  236. when run as root:
  237.  
  238. /usr/lib/news/etc/rc.news
  239.  
  240. Use "ps -x" to see if INN is running. The entry should look something like
  241. this:
  242.    88 con S     0:00 /usr/lib/news/etc/innd -p4 -i0
  243.    97 con S     0:00 /usr/lib/news/bin/overchan
  244.  
  245. Run /usr/lib/news/bin/inncheck (This requires you to have installed the perl 
  246. package) as root. This checks the configuration files for errors and informs 
  247. you. You will probably get the following error, which is OK:
  248. /usr/lib/news/newsfeeds:0: ME entry accepts all incoming article distributions
  249.  
  250. Run /usr/lib/news/bin/news.daily as user "news". Do this from root user by:
  251. su news -c /usr/lib/news/bin/news.daily &
  252.  
  253. Ensure every file and directory under /var/log/news is owned by news.news.
  254.  
  255. Try running a news reader (eg TIN), and posting a message in "junk"- does it
  256. post OK, and come up as a new article?
  257.  
  258. Try reading man-pages for the files and programs used, as well as the text
  259. files in /usr/lib/news/tools/linux.
  260.  
  261.  
  262. FINALLY
  263. =======
  264. This is the last bit, just to make sure that all the administration is setup
  265. OK.
  266.  
  267. /etc/rc.d/rc.local
  268. ------------------
  269. I have added an entry here to start up INN on bootup. Add this when you have
  270. INN working properly.
  271.  
  272.  
  273. crontab.news
  274. ------------
  275. This is the crontab for the user "news". To add it, use the following command
  276. from root user:
  277. crontab crontab.news -u news
  278.  
  279. Beware - this replaces any previous one you have for the user "news". All this
  280. crontab does is:
  281. * at 10pm every day, run the "news.daily" script and expire old articles.
  282.  
  283. This is pretty much the "default" news crontab (installed with Slackware), 
  284. so you may prefer to check the one you have, rather than overwriting it.
  285.  
  286.  
  287. READY TO RECEIVE NEWS?
  288. ======================
  289. The remaining files that I have included are the binary and manual for
  290. "slurp", and the edited script "procnews". Check that the programs run in 
  291. the script files are correct (ie correct paths). Install all these files 
  292. (I recommend slurp.1 in /usr/local/man/man1, and the rest of the scripts 
  293. + slurp in /usr/local/sbin [with demon.dip in /usr/local/etc]), and any 
  294. others mentioned.
  295.  
  296. If you are generally using ELF binaries (Slackware 3.0+) it is advisable 
  297. to use the slurp-1.10.ELF (slurp ELF binary). Similarly, if you are generally 
  298. using AOUT binaries (Slackware 2.3 and earlier), it may be advisable to use 
  299. the slurp-1.10.aout (slurp aout binary). The reason for this is that running 
  300. both ELF and AOUT binaries causes both ELF and aout libraries to be loaded, 
  301. using up more RAM.
  302.  
  303. Try dialing up Demon to test the News connection.
  304.  
  305.  
  306. ADDING / DELETING GROUPS
  307. ========================
  308. If you want to add or delete (or do pretty much any news admin), you must
  309. use /usr/lib/news/bin/ctlinnd. It is best to read the man page on this, but
  310. here are some elementary processes:
  311.  
  312. Adding group "demon.local":  /usr/lib/news/bin/ctlinnd newgroup demon.local
  313. Removing above group:         /usr/lib/news/bin/ctlinnd rmgroup demon.local
  314. Pause INN:             /usr/lib/news/bin/ctlinnd pause "reason"
  315. Reload all INN config files: /usr/lib/news/bin/ctlinnd reload all "reason"
  316. Restart INN:             /usr/lib/news/bin/ctlinnd go "reason"
  317.  
  318.  
  319.  
  320. PROBLEMS
  321. ========
  322.  
  323. Here are a few problems that I have encountered / heard of which may help you:
  324.  
  325. INN exits after I start it
  326. --------------------------
  327. This may be because the permissions for all the history files are incorrect.
  328. A common problem is that they have owner/group as root/root rather than
  329. news/news. Use chown to change this.
  330. Another possible error is that the newsgroups control and junk have not been
  331. added to the active list (this is a problem when trying to run innd in debug
  332. mode).
  333.  
  334.  
  335. I specify a newsgroup in SLURP.SYS, but the articles go to "junk"
  336. -----------------------------------------------------------------
  337. This is because you have not specified that newsgroup to INN. You can either
  338. manually edit the "active" file (not so good), or you can use "ctlinnd
  339. newgroup NEWS.GROUP.NAME" to add the group.
  340.  
  341.  
  342. Slurp expects slurp.sys to be in /usr/local/lib news
  343. ----------------------------------------------------
  344. That is correct, as the author of slurp wrote it for use with CNews. However
  345. it can be used with INN. The Slackware INN_PKG _should_ have made a link
  346. between /usr/local/lib/news and /usr/lib/news upon installation. If this
  347. has not been made use the following command (as root) to create it:
  348. cd /usr/local/lib ; ln -s news ../../lib/news
  349.  
  350.  
  351. Sending mail causes a "host unknown" error and returned mail
  352. ------------------------------------------------------------
  353. Ah - this is nothing to do with INN as such. It is to do with the setup of
  354. your MTA (Mail Transport Agent) - generally either Sendmail or Smail. The
  355. setup should be detailed in one of the other general Demon/Slackware
  356. packages. I hacked the /etc/sendmail.cf file to work to add the following:
  357.     # "Smart" relay host (may be null)
  358.     DSsmtp:post.demon.co.uk
  359. The DS macro is blank as default. Fingers crossed you should not get this 
  360. error message again - sendmail should send the post to the mail server
  361. pointed to by the MX records at Demon (this is the same for postings 
  362. outside Demon).
  363.  
  364.  
  365. When part-way through a news download it stops, mentioning unbatching.
  366. ----------------------------------------------------------------------
  367. This is because "rnews -U" has been run in the middle of the download. This
  368. causes slurp to get mixed up. Unfortunately I had set "rnews -U" to run at
  369. quarter-past the hour in the news crontab. This is now fixed (news is
  370. downloaded) to ..../in.coming/tmp and moved back to ..../in.coming for
  371. unbatching.[v0.6]
  372.  
  373.  
  374. I get a "480 Transfer permission denied" error on trying to post locally.
  375. -------------------------------------------------------------------------
  376. This is probably due to you not adding an entry for your machine into the 
  377. hosts.nntp file. See below.
  378.  
  379.  
  380. I get my hostname entered twice on the path line of all my news postings.
  381. -------------------------------------------------------------------------
  382. This should not cause a problem .... just look horrible. This is due to the
  383. work around I had to do to get the "NNTP-Posting-Host" entry correct (rather 
  384. than saying "localhost", it now states your machine). I believe this is a 
  385. Linux-specific problem (not INN) - if this is so it will hopefully get fixed 
  386. soon in the kernel upgrades.
  387.